home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 676 / fbm / fbm10man.zoo / MAN / fbsample.man < prev    next >
Text File  |  1990-12-18  |  4KB  |  133 lines
  1.  
  2.      FBSAMPLE(1)                   25-Jun-90                    FBSAMPLE(1)
  3.  
  4.  
  5.           3 
  6.  
  7.      ›1mNAME 
  8.           ›0mfbsample \- convert 1bit image to grayscale by sampling 
  9.  
  10.      ›1mSYNOPSIS 
  11.           ›0mfbsample [ -t'title' -c'credits' -g'grain' -n'nbr']
  12.                    [ -<type> ] < bitmap > image
  13.  
  14.      ›1mDESCRIPTION 
  15.  
  16.                ›0mSamples   a   1  bit  deep  pbm  file  using  a  square
  17.           neighborhood of the specified size, and  outputs  an  8  bit
  18.           file.   You  will want to run ›3mfbnorm ›0mon the output to expand
  19.           the scale to  255,  and  there  will  be  a  small  loss  of
  20.           sharpness, so ›3mfbsharp ›0mwill also be useful.  Once you have an
  21.           8  bit file, you can resize it arbitrarily, and then convert
  22.           it back  to  a  1  bit  file,  if  need  be.    The  default
  23.           neighborhood  size  is 8 by 8, which gives 65 different gray
  24.           levels.  
  25.  
  26.      ›1mOPTIONS 
  27.  
  28.           ›0m-›1mg ›0m›3mgrain ›0msize.  The sample is taken every ›3mgrain ›0mpixels.  
  29.  
  30.           -›1mn ›0m›3mneighborhood ›0msize.  The value will be the number of light
  31.           pixels in the nearby NxN square.  The values can range  from
  32.           1 to 16.  
  33.  
  34.           title'' .bo "-t'title' ›3mtitle, ›0mspecify a character string (up
  35.           to 80  characters) to describe the image.  The default is no
  36.           title.  
  37.  
  38.           credits'' .bo "-c'credits' ›3mcredits or  subtitle,  ›0mspecify  a
  39.           second  character  string  (up to 80 characters) to describe
  40.           the image.  The default is no credit string.  
  41.  
  42.           -›1mB ›0m›3mface ›0mformat, as used by Bennet Yee's ›3mface ›0mprogram at CMU. 
  43.  
  44.           -›1mF ›0m›3mFBM,  ›0mformat  (by  default,  the  default).     You   are
  45.           guaranteed  not to lose information by specifying FBM as the
  46.           default.  
  47.  
  48.           -›1mG ›0m›3mGIF, ›0mCompuserve GIF format.  
  49.  
  50.           -›1mI ›0m›3mIFF ›0mformat, interleaved bitmaps (ILBM), used by Amigas.  
  51.  
  52.           -›1mP ›0m›3mPBM, ›0mJef Poskanzer's bitmap format.  
  53.  
  54.           -›1mS ›0m›3msun, ›0mSun rasterfiles (not run length encoded).  
  55.  
  56.  
  57.           ›1mEXAMPLE 
  58.  
  59.                ›0mSuppose you have a 480 by 600  face  format  file  (-B)
  60.           that  you  wish  to  shrink  to  300  by  375 and convert to
  61.           PostScript (say for inclusion in your door label).  Here's a
  62.           pipeline to do that: 
  63.  
  64.  
  65.                                       -1-
  66.  
  67.  
  68.      FBSAMPLE(1)                   25-Jun-90                    FBSAMPLE(1)
  69.  
  70.  
  71.               % fbsample -n5 -g1 < my.face | \    # sample 5x5
  72.                 fbnorm -b4 -w1 |                  # normalize
  73.                 fbext -w300 | \                   # make 300 pixels wide
  74.                 fbhalf -s20 | \                   # halftone and really sharpen
  75.                 pbm2ps -s 1 > sdoor.ps            # convert to postscript
  76.  
  77.      ›1mSEE ALSO 
  78.           ›0mfbnorm(1)  to  normalize  the  output,  fbm(1)  for  general
  79.           discussion, pbm(1) for PBM routines.  
  80.  
  81.      ›1mBUGS 
  82.           ›0mNone known.  
  83.  
  84.      ›1mHISTORY 
  85.           ›0mCopyright  (C)  1989,1990  by Michael Mauldin. Permission is
  86.           granted to use this  file  in  whole  or  in  part  for  any
  87.           purpose,  educational,  recreational or commercial, provided
  88.           that this copyright notice  is  retained  unchanged.    This
  89.           software is available to all free of charge by anonymous FTP
  90.           and in the UUNET archives.  
  91.  
  92.           25-Jun-90  Michael  Mauldin  at  Carnegie  Mellon University
  93.           Release 1.0 mlmcs.cmu.edu 
  94.  
  95.           07-Mar-89 Michael L. Mauldin at Carnegie  Mellon  University
  96.           Beta release (version 0.9) mlmcs.cmu.edu 
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                       -2-
  132.  
  133.